home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / internet / miami_dodatki / togmi / togmi.doc < prev    next >
Text File  |  1996-08-03  |  4KB  |  106 lines
  1.  
  2. TogMi 1.0 by Mat Bettinson
  3.  
  4. * What is TogMi?
  5.  
  6. TogMi is an Arexx script for controlling the new Miami TCP/IP stack by
  7. Holger Kruse. Normally to dial up and hang up, you will need to open the
  8. Miami GUI and click on the buttons. With TogMi and it's launch icon, you
  9. only need to click on an icon to Toggle Miami's state, hence the name. 
  10.  
  11. * How does it work?
  12.  
  13. TogMi is configurable in as far as what little it does. If it's activated
  14. but Miami is not currently running, it has the option of launching Miami
  15. and then dialling up. If Miami is running, it will instruct Miami to dial
  16. up. Likewise if Miami is on-line it will instruct Miami to hang up.
  17.  
  18. * Requirements?
  19.  
  20.  1. RexxMast active, TogMi is an Arexx script.
  21.  2. TogMi.rexx in the rexx: assign.
  22.  3. The Miami TCP/IP stack. Dow!
  23.  4. The rexxtricks.library but not essential.
  24.  5. OS 2.x I guess though only tested on 3.x
  25.  
  26. * Installation;
  27.  
  28. 1> Copy TogMi.rexx to rexx:
  29.  
  30. 2> Copy rexxtricks.library to libs: if tooltype reading is required. This
  31. is a 50K library or so, perhaps low memory users might like to skip it.
  32.  
  33. 3> Drag TogMi icon to where it's required. Highlight it and select 'Leave
  34. Out' from the Workbench menus. Simple move the icon on WB to where you want
  35. it to stay and then use the icon snapshot function.
  36.  
  37. * Configuration;
  38.  
  39. TogMi has it's configuration in two places. One in the icon tooltypes and
  40. the other in the header of the script file. If for any reason TogMi can not
  41. read the icon tooltypes, the defaults in the header of the script file will
  42. be used.
  43.  
  44. A word of warning, because the TogMi script is activated from a small DOS
  45. script via IconX, any REAL tooltypes will cease to make it work. I don't
  46. really understand why but the workaround is by using fake tooltypes. By
  47. this I mean that there is simply no '=' sign between the tooltype label and
  48. the value. Just click on the TogMi icon, select icon information and see
  49. for yourself.
  50.  
  51. Description of Tooltypes;
  52.  
  53. MiamiDir - Followed by the path where Miami resides. TogMi uses this path
  54. to find 'Miami' to run if it is instructed to do so (and it's not running
  55. already obviously).
  56.  
  57. Default setting: MiamiDir Store:Miami (Miami path)
  58.  
  59. NB Useless setting obvious. If you don't change this, TogMi will complain
  60. it can't find Miami to run it.
  61.  
  62. RunMiami - YES or NO, simply whether or not to run Miami if it's not
  63. running already. Make sure your Miami configuration is Miami.default in
  64. this case as that's all it'll load before Miami dials out.
  65.  
  66. Default setting: RunMiami YES         (If not running)
  67.  
  68. KilMiami - YES or NO, dubious setting that when instructed to hang-up Miami
  69. will QUIT Miami totally. This usually doesn't have pleasant side effects
  70. for any TCP clients currently running. Not recommended.
  71.  
  72. Default setting: KilMiami NO          (On hang-up)
  73.  
  74. Window - Top left X pos, Top left Y pos, width, height. Sets the size of
  75. the CON: which TogMi will open to report it's status. You obviously don't
  76. want it too large, TogMi is supposed to be a Stealth App TM :-)
  77.  
  78. Default setting: Window 300,20,400,50 (x,y,wid,height)
  79.  
  80. Iconify - YES or NO. Tricky one since at time of writing Miami was, rather
  81. oddly for a MUI app, not paying attention to 'SHOW' and 'HIDE'. Holger has
  82. been told so I'm sure it'll reappear in the next release. This Deiconifies
  83. Miami during the dial phase and reiconifies Miami after it. For those who
  84. must watch a dial script in action. :-)
  85.  
  86. Default setting: Iconify YES          (spesh iconify)
  87.  
  88. SetMiami - The name of a configuration file in Miami's directory. This way
  89. you can specify what configuration to load up and dial out. A nice
  90. application would be to have different copies of the TogMi icon with
  91. different configurations specified in the tooltypes. I use this myself for
  92. the different providers I use. The hassle is, I'm afraid, you can't rename
  93. the TogMi icon since I can't tell the name of the 
  94.  
  95. Default setting: SetMiami Miami.default (configuration)
  96.  
  97. * Future?
  98.  
  99. That depends on what Miami gets as far as an Arexx port and what really
  100. needs to be done. Basically not much extra I can think of but I'm open to
  101. suggestions.
  102.  
  103. Enjoy,
  104.  
  105. Mat Bettinson - mat@cu-amiga.co.uk
  106.